<!DOCTYPE html>
<html>
  <head>
    <meta name="creator" content="mantohtml v2.0.1">
    <title>cupsfilter(8)</title>
  </head>
  <body>
    <h1 id="cupsfilter-8">cupsfilter(8)</h1>
    <h2 id="cupsfilter-8.name">Name</h2>
<p>cupsfilter - convert a file to another format using cups filters (deprecated)
</p>
    <h2 id="cupsfilter-8.synopsis">Synopsis</h2>
<p><strong>cupsfilter</strong>
[
<strong>--list-all</strong>
] [
<strong>--list-filters</strong>
] [
<strong>-D</strong>
] [
<strong>-U</strong>
<em>user</em>
] [
<strong>-c</strong>
<em>config-file</em>
] [
<strong>-d</strong>
<em>printer</em>
] [
<strong>-e</strong>
] [
<strong>-i</strong>
<em>mime/type</em>
] [
<strong>-j</strong>
<em>job-id[,N]</em>
] [
<strong>-m</strong>
<em>mime/type</em>
] [
<strong>-n</strong>
<em>copies</em>
] [
<strong>-o</strong>
<em>name=value</em>
] [
<strong>-p</strong>
<em>filename.ppd</em>
] [
<strong>-t</strong>
<em>title</em>
] [
<strong>-u</strong>
]
<em>filename</em>
</p>
    <h2 id="cupsfilter-8.description">Description</h2>
<p><strong>cupsfilter</strong>
is a front-end to the CUPS filter subsystem which allows you to convert a file to a specific format, just as if you had printed the file through CUPS. By default,
<strong>cupsfilter</strong>
generates a PDF file. The converted file is sent to the standard output.
</p>
    <h2 id="cupsfilter-8.options">Options</h2>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--list-all</strong><br>
Do not actually run the filters, just print all of the filters used with the source and destination MIME media types to stdout.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--list-filters</strong><br>
Do not actually run the filters, just print the filters used to stdout.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-D</strong><br>
Delete the input file after conversion.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>user</em><br>
Specifies the username passed to the filters. The default is the name of the current user.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong><em>config-file</em><br>
Uses the named cups-files.conf configuration file.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>printer</em><br>
Uses information from the named printer.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-e</strong><br>
Use every filter from the PPD file.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-i </strong><em>mime/type</em><br>
Specifies the source file type. The default file type is guessed using the filename and contents of the file.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-j </strong><em>job-id[,N]</em><br>
Converts document N from the specified job. If N is omitted, document 1 is converted.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-m </strong><em>mime/type</em><br>
Specifies the destination file type. The default file type is application/pdf. Use printer/foo to convert to the printer format defined by the filters in the PPD file.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-n </strong><em>copies</em><br>
Specifies the number of copies to generate.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong><em>name=value</em><br>
Specifies options to pass to the CUPS filters.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>filename.ppd</em><br>
Specifies the PPD file to use.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t </strong><em>title</em><br>
Specifies the document title.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u</strong><br>
Delete the PPD file after conversion.
</p>
    <h2 id="cupsfilter-8.exit-status">Exit Status</h2>
<p><strong>cupsfilter</strong>
returns a non-zero exit status on any error.
</p>
    <h2 id="cupsfilter-8.environment">Environment</h2>
<p>All of the standard
<strong>cups</strong>(1)

environment variables affect the operation of
<strong>cupsfilter</strong>.

</p>
    <h2 id="cupsfilter-8.files">Files</h2>
    <pre>/etc/cups/cups-files.conf
/etc/cups/*.convs
/etc/cups/*.types
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
</pre>
    <h2 id="cupsfilter-8.notes">Notes</h2>
<p>CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
Printers that do not support IPP can be supported using applications such as
<strong>ippeveprinter</strong>(1).

</p>
    <p>Unlike when printing, filters run using the
<strong>cupsfilter</strong>
command use the current user and security session. This may result in different output or unexpected behavior.
</p>
    <h2 id="cupsfilter-8.example">Example</h2>
<p>The following command will generate a PDF preview of job 42 for a printer named &quot;myprinter&quot; and save it to a file named &quot;preview.pdf&quot;:
</p>
    <pre>
    cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
</pre>
    <h2 id="cupsfilter-8.see-also">See Also</h2>
<p><strong>cups</strong>(1),

<strong>cupsd.conf</strong>(5),

<strong>filter(7),</strong>

<strong>mime.convs</strong>(7),

<strong>mime.types</strong>(7),

CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
    <h2 id="cupsfilter-8.copyright">Copyright</h2>
<p>Copyright &copy; 2020-2024 by OpenPrinting.
  </body>
</html>
